Créer et détruire les objets

Créer et détruire les objets

createBezierLine(...)
createBezierLine(liste, ["nom"]) -> chaîne

Crée une nouvelle courbe de Bézier et retourne son nom. Les points de la courbe de bezier sont conservés dans la "liste", dans l'ordre suivant: [x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn] Dans la liste de points, x et y sont les coordonnées x et y du point et kx et ky représentent le point de contrôle de la courbe. Les coordonnées sont fournies dans les unités de mesure du document (voir les constantes UNIT). La valeur de "nom" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à cet objet. Si "nom" n'est pas fourni, Scribus en créera un pour vous.

Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé. Peut générer ValueError si le nombre de points précisé est insuffisant ou si le nombre de valeurs passées ne forme pas un groupe de points entier, sans reste.

createEllipse(...)
createEllipse(x, y, largeur, hauteur, ["nom"]) -> chaîne

Crée une nouvelle ellipse dans la page courante et retourne son nom. Les coordonnées sont données dans les unités de mesure du document (voir les constantes UNIT). La valeur de "nom" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à l'objet désigné. Si "nom" n'est pas fourni, Scribus en créera un pour vous.

Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.

createImage(...)
createImage(x, y, largeur, hauteur, ["nom"]) -> chaîne

Crée un nouveau cadre d'image dans la page courante et retourne son nom. Les coordonnées sont affichées dans les unités de mesure du document. La valeur de "nom" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à cet objet. Si "nom" n'est pas fourni, Scribus en créera un pour vous.

Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.

createLine(...)
createLine(x1, y1, x2, y2, ["nom"]) -> chaîne

Crée une nouvelle ligne à partir du point(x1, y1) et du point(x2, y2) et retourne son nom. Les coordonnées sont affichées dans les unités de mesure du document (voir les constantes UNIT). La valeur de "nom" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à cet objet. Si "nom" n'est pas fourni, Scribus en créera un pour vous.

Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.

createPathText(...)
createPathText(x, y, "boiteTexte", "courbeBezier", ["nom"]) -> chaîne

Crée un nouveau pathText en combinant les deux objets "boîte de texte" et "courbe de Bézier", puis retourne son nom. Les coordonnées sont affichées dans les unités de mesure du document (voir les constantes UNIT). La valeur de "nom" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à cet objet. Si "nom" n'est pas fourni, Scribus en créera un pour vous.

Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé. Peut générer NotFoundError si l'un des objets de base (ou les deux) n'existent pas.

createPolyLine(...)
createPolyLine(liste, ["nom"]) -> chaîne

Crée un nouveau polyline et retourne son nom. Les points de l'élément polyline sont conservés dans la "liste", dans l'ordre suivant : [x1, y1, x2, y2...xn. yn]. Les coordonnées sont données dans les unités de mesure du document (voir les constantes UNIT). La valeur de "nom" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à cet objet. Si "nom" n'est pas fourni, Scribus en créera un pour vous.

Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé. Peut générer ValueError si le nombre de points précisé est insuffisant ou si le nombre de valeurs passées ne forme pas un groupe de points entier, sans reste.

createPolygon(...)
createPolygon(liste, ["nom"]) -> chaîne

Crée un nouveau polygone et retourne son nom. Les points du polygone sont conservés dans la "liste", dans l'ordre suivant: [x1, y1, x2, y2...xn. yn]. Au moins trois points sont requis. Il n'est pas nécessaire de répéter le premier point pour fermer le polygone. Le polygone se ferme automatiquement avec la connexion du premier et du dernier point. Les coordonnées sont données dans les unités de mesure du document (voir les constantes UNIT). La valeur de "nom" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à cet objet. Si "nom" n'est pas fourni, Scribus en créera un pour vous.

Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé. Peut générer ValueError si le nombre de points précisé est insuffisant ou si le nombre de valeurs passées ne forme pas un groupe de points entier, sans reste.

createRect(...)
createRect(x, y, largeur, hauteur, ["nom"]) -> chaîne

Crée un nouveau rectangle dans la page courante et retourne son nom. Les coordonnées sont données dans les unités de mesure du document (voir les constantes UNIT). Le "nom" doit être un identifiant unique parce que vous en aurez besoin pour des références futures à l'objet désigné. Si "nom" n'est pas fourni, Scribus en créera un pour vous.

Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.

createText(...)
createText(x, y, largeur, hauteur, ["nom"]) -> chaîne

Crée un nouveau cadre de texte dans la page courante et retourne son nom. Les coordonnées sont données dans les unités de mesure du document (voir les constantes UNIT). La valeur de "nom" doit être un identifiant unique parce que vous en aurez besoin pour accéder plus tard à l'objet désigné. Si "nom" n'est pas fourni, Scribus en créera un pour vous.

Peut générer NameExistsError si vous passez explicitement un nom déjà utilisé.

deleteObject(...)
deleteObject(["nom"])

Supprime l'élément portant le nom "nom". Si "nom" n'est pas fourni, l'élément sélectionné est supprimé.

getAllStyles(...)
getAllStyles() -> liste

Retourne une liste des noms de tous les styles de paragraphe du document courant.

objectExists(...)
objectExists(["nom"]) -> booléen

Teste si un objet avec le nom spécifié existe réellement dans le document. Le paramètre optionnel est le nom de l'objet. Lorsqu'aucun nom d'objet n'est donné, retourne la valeur True si un élément est sélectionné.